home *** CD-ROM | disk | FTP | other *** search
/ ClipArt Heaven 2 / ClipArt Heaven 2.iso / utility / grab396 / gredit.doc < prev    next >
Text File  |  1992-02-04  |  18KB  |  485 lines
  1.  
  2.  
  3.  
  4.                                      GREDIT (tm)
  5.                                 Shareware Release 4.3A
  6.  
  7.                             -----------------------------
  8.  
  9.                          A display screen editor for use with
  10.                        the GRABBER (tm) screen capture program
  11.  
  12.  
  13.  
  14.                                     DOCUMENTATION
  15.                                    February 4, 1992
  16.  
  17.  
  18.  
  19.                                Copyright 1991, 1992 by
  20.                                    Gerald A. Monroe
  21.                               All rights reserved except
  22.                              as expressly provided here.
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.           YOUR LICENSE TO USE THIS SOFTWARE:
  32.           -----------------------------------
  33.  
  34.           This documentation file and the GREDIT.EXE program are Copyright
  35.           1991, 1992, by Gerald A. Monroe.  All rights are reserved except
  36.           as expressly provided here.
  37.  
  38.           These files have been distributed as part of the GRABBER(tm)
  39.           screen capture package, under the terms of a shareware license
  40.           that is fully set forth in the file GRABBER.DOC.  (GRABBER.DOC is
  41.           the reference manual for GRABBER.EXE, which is the main program
  42.           module in the package.)
  43.  
  44.           The shareware license terms in the GRABBER.DOC file are incorpo-
  45.           rated here by reference.  This license permits you to copy and
  46.           distribute the files listed in the first paragraph above, provid-
  47.           ed that:  these files are always distributed together with each
  48.           other and with the GRABBER.EXE and GRABBER.DOC files; none of the
  49.           files is modified in any way; and no fee, premium or donation of
  50.           any kind is charged or requested for their distribution except as
  51.           permitted on the terms described in the GRABBER.DOC file.
  52.  
  53.           Continued use of any of these programs for more than a 10-day
  54.           trial period requires you to register your use of the software
  55.           with the author.  For more information about the benefits of
  56.           registration and how to go about registering, please refer to the
  57.           full licensing and ordering information in the GRABBER.DOC file.
  58.  
  59.           GREDIT                    Documentation               Page 2 of 9
  60.  
  61.  
  62.  
  63.                                   Table of Contents
  64.  
  65.                    Overview of GREDIT . . . . . . . . . . . . . . 3
  66.  
  67.                    Hardware & software requirements . . . . . . . 3
  68.  
  69.                    Starting GREDIT  . . . . . . . . . . . . . . . 3
  70.  
  71.                    Editing the GRABBER offspring file . . . . . . 4
  72.  
  73.                    Cursor movement keys . . . . . . . . . . . . . 4
  74.  
  75.                    Help screen, Alt-H . . . . . . . . . . . . . . 5
  76.  
  77.                    Quit GREDIT, Alt-Q . . . . . . . . . . . . . . 5
  78.  
  79.                    Save image to .EXE file, Alt-S . . . . . . . . 5
  80.  
  81.                    Save image to ANSI file, Alt-A . . . . . . . . 5
  82.  
  83.                    Set colors, Alt-F  . . . . . . . . . . . . . . 5
  84.  
  85.                    Toggle blink, Alt-L  . . . . . . . . . . . . . 5
  86.  
  87.                    Border color, Alt-B  . . . . . . . . . . . . . 6
  88.  
  89.                    Clear screen, Alt-K  . . . . . . . . . . . . . 6
  90.  
  91.                    Erase line, Alt-E  . . . . . . . . . . . . . . 6
  92.  
  93.                    Wipe screen, Alt-W . . . . . . . . . . . . . . 6
  94.  
  95.                    Toggle ruler, Alt-R  . . . . . . . . . . . . . 6
  96.  
  97.                    Set tabs, Alt-T  . . . . . . . . . . . . . . . 6
  98.  
  99.                    Import text file, Alt-I  . . . . . . . . . . . 7
  100.  
  101.                    Load new image, Alt-N  . . . . . . . . . . . . 7
  102.  
  103.                    Copy to clipboard, Alt-C . . . . . . . . . . . 7
  104.  
  105.                    Cut to clipboard, Alt-X  . . . . . . . . . . . 7
  106.  
  107.                    Paste from clipboard, Alt-P  . . . . . . . . . 8
  108.  
  109.                    Line-drawing help, Alt-D . . . . . . . . . . . 8
  110.  
  111.                    Graphics character help, Alt-G . . . . . . . . 8
  112.  
  113.                    Query colors at cursor, Alt-Y  . . . . . . . . 8
  114.  
  115.                    Turning off GREDIT's beep sounds . . . . . . . 9
  116.  
  117.           GREDIT                    Documentation               Page 3 of 9
  118.  
  119.  
  120.  
  121.           OVERVIEW OF GREDIT
  122.           -------------------
  123.  
  124.           GREDIT(tm) is a utility you can use to modify the screen images
  125.           which are generated by the GRABBER screen capture program. 
  126.           Throughout this document, these screen image files are referred
  127.           to as GRABBER "offspring."  If you are not familiar with GRABBER
  128.           and how it works, please read the program manual GRABBER.DOC
  129.           before attempting to use GREDIT.
  130.  
  131.           Only text images captured with GRABBER may be edited.  GREDIT
  132.           does not support GRABBER's graphic images.
  133.  
  134.  
  135.  
  136.           REQUIREMENTS
  137.           -------------
  138.  
  139.           GREDIT has the same hardware and software requirements as GRAB-
  140.           BER.  These are:
  141.  
  142.                a)   an IBM-PC, XT, AT, PS/2 or 100% IBM-compatible personal
  143.                     computer;
  144.  
  145.                b)   PC-DOS or MS-DOS, Version 3.0 or later; c) at least one
  146.                     diskette drive; and c) at least 256Kb free memory.
  147.  
  148.           You can use GREDIT with either a color or monochrome display.
  149.  
  150.  
  151.  
  152.           STARTING GREDIT
  153.           ----------------
  154.  
  155.           To start the program, simply type GREDIT at the DOS prompt,
  156.           optionally followed by the name of the GRABBER offspring file you
  157.           wish to edit, then press <RETURN>.  The correct syntax is:
  158.  
  159.                                   GREDIT [filename]
  160.  
  161.           If you omit the filename, the program will ask you to supply one.
  162.  
  163.           GREDIT assumes that the file you wish to edit has the extension
  164.           ".EXE" in its name.  Therefore, you can omit the extension when
  165.           specifying the file to be edited.  For instance, entering "GREDIT
  166.           SCREEN00" is the same as entering "GREDIT SCREEN00.EXE".
  167.  
  168.           GREDIT                    Documentation               Page 4 of 9
  169.  
  170.  
  171.  
  172.           EDITING THE OFFSPRING FILE
  173.           ---------------------------
  174.  
  175.           You are now inside GREDIT, with the cursor at the upper left-hand
  176.           corner of the screen.  You may use your keyboard to edit the
  177.           image inside the GRABBER offspring file, including its text
  178.           content, layout and color scheme.  At your disposal are all of
  179.           the alphanumeric and cursor-movement keys, the function keys <F1>
  180.           through <F10>, plus 17 special Alt-key functions which are
  181.           described below.
  182.  
  183.  
  184.  
  185.           CURSOR MOVEMENT
  186.           ----------------
  187.  
  188.           GREDIT supports the following keys on your PC keyboard to help
  189.           you move around inside your GRABBER offspring image.  Except for
  190.           the backspace key ( <X] ), none of these keys alters the image on
  191.           the screen; they merely move the editing cursor to the desired
  192.           location.
  193.  
  194.  
  195.           [UP ARROW]  . . . . . . cursor up one line
  196.           [DOWN ARROW]  . . . . . cursor down one line
  197.           [LEFT ARROW]  . . . . . cursor one space to the left
  198.           [RIGHT ARROW] . . . . . cursor one space to the right
  199.           [HOME]  . . . . . . . . cursor to upper left corner of display
  200.           [PAGE UP] . . . . . . . cursor to upper right corner of display
  201.           [END] . . . . . . . . . cursor to lower left corner of display
  202.           [PAGE DOWN] . . . . . . cursor to lower right corner of display
  203.           [RETURN]  . . . . . . . cursor to left edge, next line down
  204.           [TAB] . . . . . . . . . cursor right to next tab stop
  205.           [SHIFT-TAB] . . . . . . cursor left to previous tab stop
  206.           [BACKSPACE] . . . . . . cursor one space left, erase char. there
  207.  
  208.  
  209.           The [INSERT] key deserves a special mention.  This key does not
  210.           allow you to insert characters into a line as you would expect
  211.           using a word processor.  Rather, holding down the [INSERT] key
  212.           while pressing another alphanumeric or function key 1-10 causes
  213.           the editing cursor to advance backward from right to left.  This
  214.           can be helpful when drawing boxes with the <F1-F10> keys.
  215.  
  216.           GREDIT                    Documentation               Page 5 of 9
  217.  
  218.  
  219.  
  220.           GREDIT ALT-KEY FUNCTIONS
  221.           -------------------------
  222.  
  223.  
  224.             KEY                          FUNCTION
  225.           -------   ------------------------------------------------------
  226.  
  227.           Alt-H     Help
  228.  
  229.                     This function pops up a list of all of GREDIT's special
  230.                     Alt-key functions and a brief description of each. 
  231.                     Press any key to resume editing.
  232.  
  233.  
  234.           Alt-Q     Quit
  235.  
  236.                     This function exits GREDIT, and gives you the option of
  237.                     saving your changes to disk before leaving.
  238.  
  239.  
  240.           Alt-S     Save
  241.  
  242.                     This function saves your changes to disk without exit-
  243.                     ing the program.
  244.  
  245.  
  246.           Alt-A     Save to ANSI file
  247.  
  248.                     This function saves the current image to an ANSI-en-
  249.                     coded file.  ANSI files are text files which contain
  250.                     special control codes that preserve all of the colors
  251.                     in the image.  The Alt-A function performs the same
  252.                     task as the separate GR2ANSI(tm) program, a command-
  253.                     line utility which is also included in the GRABBER
  254.                     package.
  255.  
  256.  
  257.           Alt-F     Colors
  258.  
  259.                     This function lets you change the global color attrib-
  260.                     ute.  To adjust the foreground color, press the up and
  261.                     down arrow keys.  To adjust the background color, press
  262.                     the left and right arrow keys.  To resume editing,
  263.                     press <Esc> or <Return>.  Users with monochrome systems
  264.                     should also read about the Alt-Y function below.
  265.  
  266.  
  267.           Alt-L     Blink
  268.  
  269.                     This function toggles the "blink" attribute on and off
  270.                     for characters typed at the keyboard.
  271.  
  272.           GREDIT                    Documentation               Page 6 of 9
  273.  
  274.  
  275.  
  276.             KEY                          FUNCTION
  277.           -------   ------------------------------------------------------
  278.  
  279.           Alt-B     Border color
  280.  
  281.                     This function lets you adjust the color of the screen
  282.                     border on color systems.  Border color is not available
  283.                     on monochrome systems.
  284.  
  285.  
  286.           Alt-K     Clear screen
  287.  
  288.                     This function erases the entire display, and fills it
  289.                     with the last color you specified using the Alt-F
  290.                     function.
  291.  
  292.  
  293.           Alt-E     Erase line
  294.  
  295.                     This function erases the line on which the cursor is
  296.                     currently located.  To avoid accidental erasures, Alt-E
  297.                     must be pressed twice.  The erased line will be filled
  298.                     with the last color you specified using the Alt-F
  299.                     function.
  300.  
  301.  
  302.           Alt-W     Wipe
  303.  
  304.                     This function lets you change either the foreground or
  305.                     the background color of ALL characters on the screen at
  306.                     once.  After pressing Alt-W, press <F> to wipe the
  307.                     foreground, or <B> to wipe the background, or any other
  308.                     key to cancel.  The foreground or background will be
  309.                     wiped to the last color you specified using the Alt-F
  310.                     function.
  311.  
  312.  
  313.           Alt-R     Ruler
  314.  
  315.                     This function toggles on and off the ruler display at
  316.                     the top of the screen.  The ruler shows all of the
  317.                     currently defined tab stops.  While the ruler is being
  318.                     displayed, you cannot make changes to the top line of
  319.                     the image.
  320.  
  321.  
  322.           Alt-T     Tabs
  323.  
  324.                     This function lets you adjust the tab value.  The
  325.                     minimum tab value is always 2.  The maximum value
  326.                     equals the number of character spaces per line, minus
  327.                     one.
  328.  
  329.           GREDIT                    Documentation               Page 7 of 9
  330.  
  331.  
  332.  
  333.             KEY                          FUNCTION
  334.           -------   ------------------------------------------------------
  335.  
  336.           Alt-I     Import
  337.  
  338.                     This function allows you to import plain ASCII text
  339.                     files into your image.  Imported files are overlaid
  340.                     onto whatever image already exists on the screen, using
  341.                     the foreground and background colors you specified with
  342.                     the most recent Alt-F function.  GREDIT reads in only
  343.                     as much of the text file as will fit on the screen,
  344.                     starting from the top of the file.
  345.  
  346.  
  347.           Alt-N     New offspring
  348.  
  349.                     This function lets you load and edit a new GRABBER
  350.                     offspring image.  Alt-N does not remind you to save the
  351.                     current image before loading another, so you may want
  352.                     to invoke Alt-S first.
  353.  
  354.  
  355.           Alt-C     Copy to clipboard
  356.  
  357.                     This function allows you to specify a rectangular area
  358.                     of the image to copy to GREDIT's off-screen "clipboard"
  359.                     storage area.  First, move the cursor to one of the
  360.                     four corners of the area to be copied, and press Alt-C. 
  361.                     Then, use the arrow keys to move the cursor to the
  362.                     *opposite* corner of the area to be saved, and press
  363.                     <Return>.  To confirm the area selected, press <Return>
  364.                     again, or press <Esc> to cancel.  Please note that
  365.                     GREDIT's clipboard can fit only one item at a time;
  366.                     when you copy something to the clipboard, you erase the
  367.                     clipboard's previous contents.
  368.  
  369.  
  370.           Alt-X     Cut to clipboard
  371.  
  372.                     This function works exactly like the Alt-C function de-
  373.                     scribed above, with one difference.  Whatever portion
  374.                     of the image you select will also be erased from the
  375.                     screen after it is moved to the clipboard.
  376.  
  377.           GREDIT                    Documentation               Page 8 of 9
  378.  
  379.  
  380.  
  381.             KEY                          FUNCTION
  382.           -------   ------------------------------------------------------
  383.  
  384.           Alt-P     Paste from clipboard
  385.  
  386.                     This function can be used to paste the contents of the
  387.                     clipboard back to the screen.  First, move the cursor
  388.                     to the upper-left corner of the area you wish to fill
  389.                     from the clipboard, and press Alt-P.  GREDIT will show
  390.                     you the outlines of the area saved on the clipboard. 
  391.                     To confirm the Paste operation, press <Return>, or
  392.                     press <Esc> to cancel.
  393.  
  394.  
  395.           Alt-D     Line-drawing help
  396.  
  397.                     This function pops up a list of line- and box-drawing
  398.                     characters, and the function keys (F1 through F10)
  399.                     which are associated with them.  To access these char-
  400.                     acters in GREDIT, press the function  key indicated in
  401.                     the list, either alone or together with the <Shift>,
  402.                     <Ctrl> or <Alt> keys.  Press any key to exit the list
  403.                     and resume editing.
  404.  
  405.  
  406.           Alt-G     Graphics character help
  407.  
  408.                     This function pops up a table showing all the special
  409.                     graphics characters in the IBM-PC character set.  The
  410.                     numbers at the left and top of the grid are added
  411.                     together to determine the ASCII code of any character
  412.                     in the table. To access these characters in GREDIT,
  413.                     first hold down the <Alt> key, then type the charac-
  414.                     ter's ASCII code on your keyboard's numeric keypad, and
  415.                     then release the <Alt> key.
  416.  
  417.  
  418.           Alt-Y     Query attribute at cursor
  419.  
  420.                     This function is available on monochrome systems only. 
  421.                     It allows you to determine how a certain character will
  422.                     appear if the offspring screen is later shown on a
  423.                     color display.  Move the cursor to the character you
  424.                     want to check, and press Alt-Y.  The top line of the
  425.                     display will tell you the "foreground-on-background"
  426.                     color scheme for this character if it were shown on a
  427.                     color system.
  428.  
  429.           GREDIT                    Documentation               Page 9 of 9
  430.  
  431.  
  432.  
  433.           ELIMINATING GREDIT's BEEP SOUNDS
  434.           ---------------------------------
  435.  
  436.           To eliminate the beep sounds which GREDIT normally makes when you
  437.           invoke any of its special Alt-key functions, include the /Q
  438.           command-line switch when you start the program at the DOS prompt. 
  439.           For example:
  440.  
  441.                                    GREDIT /Q
  442.                             or,
  443.                                    GREDIT screenxx /Q
  444.  
  445.           If you omit the /Q switch from the command line and later decide
  446.           to turn off the beep sounds, you must exit the program (don't
  447.           forget to save your work) and restart the program using the /Q
  448.           switch on the command line.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.                            * * *  End of GREDIT.DOC  * * *
  485.